home *** CD-ROM | disk | FTP | other *** search
/ The Game Master (3rd Edition) / The Game Master 3rd edition.iso / files / musieech / myspeech / myspeech.doc < prev   
Encoding:
Text File  |  1992-07-03  |  6.9 KB  |  141 lines
  1.      
  2.      
  3.                                 M Y S P E E C H
  4.                                   
  5.                                   
  6.                            User-supported software by      
  7.                            
  8.                                  Norman  Newman
  9.                                  Kibbutz Tsor'a
  10.                                  M.P.  Shimshon
  11.                                  ISRAEL   99705
  12.                                Fax:  972-2-908555  
  13.  
  14. Legal note
  15. ----------
  16. This program is copyright 1992 by Norman Newman, Kibbutz Tsor'a, M.P.
  17. Shimshon, ISRAEL 99705; all rights reserved, all wrongs deserved.  The program
  18. may be freely distributed and copied, provided that no changes are made in
  19. either MYSPEECH.COM or MYSPEECH.DOC (this  file).  The author denies all
  20. responsibility for any damage caused by the use  or misuse of this program.
  21.  
  22. This software is provided as shareware. This means that you have the
  23. opportunity to try MYSPEECH before having to register.  Should you decide
  24. to keep and use this program, you are requested  to  register your copy
  25. with the author by sending  a  cheque  for  $20.  This  will entitle you to
  26. receive the source code (written in assembly language) and free support.
  27.  
  28. This program is "user-driven" and suggestions for additional features are
  29. welcome. This documentation describes version 3.2, which is the current
  30. released version (5/92).
  31.  
  32. What is MYSPEECH?
  33. -----------------
  34. MYSPEECH is a program designed to help vision-impaired computer users. It
  35. is a Terminate and Stay Resident program (occupying just under 2K memory)
  36. which reads both keystrokes and screen output, and speaks them via the
  37. Speech Thing (manufactured by Covox Inc, 675 Conger Street, Eugene, Oregon
  38. USA 97402). This enables the user to hear exactly which keys s/he has
  39. pressed, as well as DOS' response to them.
  40.  
  41. The program also includes a 'screen reader' mode, in which the entire
  42. screen is read, and a 'line reader' mode, in which the screen is read, a
  43. line at a time. It is also possible to have the program speak line numbers.
  44. In 'quiet' mode, which is an adjunct to 'line reader' mode, the cursor keys
  45. work, and the program will say where the cursor is on the screen, but it
  46. will not read the contents of each line. This is useful if you wish to
  47. bring the cursor to a specific line quickly.
  48.  
  49. It should be noted that MYSPEECH gets fooled by programs which turn off the
  50. regular DOS cursor and substitute one of their own (for example, the Norton
  51. Editor). To the best of my knowledge, there is no way around this problem.
  52.  
  53. Prior to invoking MYSPEECH, you must load into memory the SPEECHV2 driver
  54. program which came with the Speech Thing. MYSPEECH will detect whether the
  55. driver is absent, but is not (presently) capable of loading it into memory.
  56. It is preferable to load both SPEECHV2 and MYSPEECH into memory from the
  57. AUTOEXEC.BAT file in order to save problems.
  58.  
  59. Program invocation
  60. ------------------
  61. MYSPEECH is executed in the following manner:
  62.  
  63. myspeech [/?] [/k+] [/k-] [/r+] [/r-] [/l+] [/l-] [/u] [/p:n] [/s:n] [/v:n]
  64. /?        This help message
  65. /k+       Activate keypresses
  66. /k-       Unactivate keypresses
  67. /r+       Activate speech
  68. /r-       Unactivate speech
  69. /l+       Speak line numbers in line reader mode
  70. /l-       Don't speak line numbers
  71. /u        Remove MySpeech from memory
  72. /p:n      Set pitch, where n = value, 0 = low, 9 = high
  73. /s:n      Set speed, where n = value, 0 = slow, 9 = fast
  74. /v:n      Set volume, where n = value, 0 = quiet, 9 = loud
  75.  
  76. ... also ...
  77. Alt/Ctrl/S speaks the entire screen
  78. Alt/Ctrl/R reads everything to the right of the cursor
  79.            allowing you to move the cursor around on the screen
  80. Alt/Ctrl/Q switches between quiet and noisy mode.
  81.  
  82. MYSPEECH may be invoked several times, although it will be loaded into
  83. memory only once. The subsequent invocations communicate with the resident
  84. copy, changing either the voice parameters, or the function of MYSPEECH (ie
  85. unactivating or activating it).
  86.  
  87. Program History
  88. ---------------
  89. Version 3.2 - 14 May 1992. 2800 bytes RAM.
  90.               1. Alt/Ctrl/Q: switches between 'quiet' and 'noisy' mode.
  91.               2. The 'u' switch also removes SpeechV2/3 from memory BUT
  92.                  does not release the MCB. I have tried using DOS function
  93.                  21h/4Ah, where ES=SpeechPtr's segment, but this doesn't 
  94.                  work.
  95.  
  96. Version 3.1 - 1 May 1992. 2768 bytes RAM.
  97.               1. Line numbers are spoken when in line reader mode. Pressing
  98.                  '-' will cause only the line numbers to be spoken. A new
  99.                  command line switch - /l - added to control this function from
  100.                  the command line.
  101.               2. The command line simplified by using /k+ and /k- instead of
  102.                  what there was previously.
  103.               3. In line reader mode, pressing '+' causes the saved cursor 
  104.                  position to be set to that of the current cursor position.
  105.                  This key press also exits line reader mode.
  106.                                
  107. Version 3.0 - 2 April 1992. 2272 bytes RAM.
  108.               1. Int 2Fh used in preparation for installation in upper
  109.                  memory blocks. 
  110.               2. A screen reader has been added:
  111.                  Alt/Ctrl/S reads and speaks the entire screen
  112.                  Alt/Ctrl/R reads and speaks the current line (and allows
  113.                  cursor movement).
  114.               3. The communication between resident and transient programs
  115.                  improved, regarding the passing of data between them.
  116.               4. The command line parser improved, both in function and in
  117.                  implementation.
  118.               5. The source code has now been chopped up into include files
  119.                  in order to simplify maintenance.
  120.  
  121. Cautions
  122. --------
  123. MYSPEECH captures the int 16h keyboard interrupt; should you load into
  124. memory another program which captures this interrupt, you will not be able
  125. to free the memory occupied by MYSPEECH until this latter program is
  126. removed. An unsuccessful attempt to remove MYSPEECH will cause it to be
  127. unactivated, however.
  128.  
  129. Although this program has been checked on several computers using several
  130. BIOS chips and with all of Covox's products (Speech Thing, Sound Master and
  131. Voice Master), it may be that this program will not work on a specific
  132. computer.  Unless you are willing to send me the money to buy an exact copy
  133. of your computer, I am afraid that you will not be able to use this
  134. program. The development of MYSPEECH was stymied for many weeks because it
  135. would work on my development system, but not on my blind friend's computer;
  136. this caused several major design changes until I found one which worked on
  137. both, and so it may be that there are other hardware combinations on which
  138. this program will not work.  There are also various programs which do not
  139. interact well with MYSPEECH, especially those which hide the hardware
  140. cursor.
  141.